home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d17 / qp260.arc / QP.DOC < prev    next >
Text File  |  1991-06-09  |  23KB  |  580 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                          Q U I C K P R I N T
  16.  
  17.  
  18.                         An easy  and fun to use
  19.                         text file print utility
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                                Version 2.60
  44.                                                June 09, 1991
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                              DISCLAIMER
  61.  
  62.  
  63.          QuickPrint is provided as is, free of charge. There are no
  64.     warranties written or otherwise implied.  While no problems are
  65.     expected the author assumes no responsibilty for damage to data
  66.     or hardware that arises out of the use of this program.
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                             INTRODUCTION
  119.  
  120.  
  121.  
  122.           QuickPrint is a handy and easy to use ASCII text print
  123.      utility.  Some of the highlights of the program are:
  124.  
  125.           -    It is "human engineered" (ergonomically designed) to
  126.                provide  maximal visual input with a minimum of fuss
  127.                (more on this later).
  128.  
  129.           -    Very few keystrokes are needed to load, view and print a
  130.                file.
  131.  
  132.           -    It tells you how many pages will be printed before
  133.                printing starts.
  134.  
  135.           -    It has a progress bar to give you quick input on the
  136.                status of the printing.
  137.  
  138.           -    It tells you which page is currently being sent to
  139.                the printer.
  140.  
  141.           -    The number of the print page you are viewing is displayed.
  142.  
  143.           -    The picklist is large, easy to read, alphabetically
  144.                sorted, includes the most important file information and
  145.                searches for names alphabetically.
  146.  
  147.           -    Works with color and monochrome monitors.
  148.  
  149.           -    Will automatically provide pagination and footers (page
  150.                numbers) for unformatted files.  If a file is formatted
  151.                with form feeds then QuickPrint will not add formfeeds
  152.                or footers.  Footers can be toggled off.
  153.  
  154.           -    Files can be tagged for easy printing of multiple files.
  155.  
  156.           -    Can print with or without line numbers.
  157.  
  158.           -    Can change number of lines printed per page.
  159.                ( Default is 58 lines not including the footer ).
  160.  
  161.           -    Can add margins to left side of page.
  162.  
  163.           -    Can print blocks of text.
  164.  
  165.           The major design philosophy behind QuickPrint's development
  166.      was that it should be a no frills, easy to use print utility that
  167.      will automatically provide pagination and page numbers.
  168.  
  169.           This makes it an excellent tool for printing Readme and
  170.      documentation files provided on disks with programs.  It is also
  171.      ideal for programmers wanting to print hardcopies of their code.
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                         USING QUICKPRINT
  178.  
  179.      A.   THE PICKLIST
  180.  
  181.           QuickPrint has been compiled as QP.EXE.  It can be started by
  182.      typing QP alone or following it with a filename.  If no name is
  183.      provided a picklist will be displayed. Starting with version 2.60
  184.      QuickPrint now handles command line arguments with more flexibility.
  185.      Typing a directory on the command line (i.e. QP direct\sub1\sub) will
  186.      list the files in the "sub"  directory. You can also follow the
  187.      directory with a filename and you will go directly into that file.
  188.      Dos wildcards are also supported ( i.e QP c:\temp\file.* ).
  189.  
  190.           The long horizontal window bar on the bottom displays identification
  191.      and the number of files in the directory. The central picklist window
  192.      displays the current directory's filenames, 21 names per display, sorted
  193.      alphabetically. The highlight bar is placed approximately in the middle
  194.      of the list to provide equal access to the filenames.
  195.  
  196.           The following keys will work to allow navigation through the
  197.      list:
  198.  
  199.           Home - This will put the highlight bar at the top on the very
  200.           first file.
  201.  
  202.           End - This puts the bar at the bottom on the very last
  203.           filename.
  204.  
  205.           PgDn - This pages down through the list displaying 21
  206.           filenames at a time.
  207.  
  208.           PgUp - Same as PgDn except pages up through the list.
  209.  
  210.           Up Arrow - Scrolls up through the list, one filename at a
  211.           time.
  212.  
  213.           Dn Arrow - Scrolls down through the list.
  214.  
  215.           Alpha Numeric - Any filename starting with a printable ASCII
  216.           character may be searched for by pressing the appropriate key.
  217.           For example, pressing the 'A' key will place the highlight bar
  218.           on the first filename starting with an A.  When possible this
  219.           name will be placed in the middle of the display.  This is not
  220.           case sensitive. Subsequent presses will scroll through the list
  221.           of files starting with that character. If possible, the
  222.           highlighted filename will remain in the middle of the list.
  223.  
  224.           Esc - Pressing the escape key terminates the program and
  225.           places you at the DOS prompt.
  226.  
  227.           Enter - Pressing the <Enter> key starts the main program and
  228.           loads the file currently highlighted. ** NOTE ** If you
  229.           tagged several files for printing, pressing <Enter> will
  230.           put you into a large window with the names of the tagged
  231.           files displayed.  The text is NOT viewed in the window
  232.           when printing multiple files like it is when only a single
  233.           ( untagged ) file is selected.  Keeping this in mind you may
  234.           want to view the files individually before tagging them.
  235.  
  236.           Space bar - The space bar will tag/untag a file for printing.
  237.           It serves as a toggle. This is used to create a list of several
  238.           files that are to be printed consecutively in the order they
  239.           are selected. When a file is tagged an asterick ( * ) will
  240.           appear next to the name.
  241.  
  242.           Alt-D  - This combination will untag all files at once.
  243.  
  244.       B.  VIEWING FILES
  245.  
  246.           Quickprint is meant to print files and is relatively crude at
  247.      displaying them.  This feature is provided so you can quickly scan
  248.      the file to determine if it's worth printing.  The selected file is
  249.      loaded into available memory.  If not enough memory is available,
  250.      only that which will fit into memory will be loaded.  The rest of
  251.      the file will be truncated.   If this occurs, you will see 'TR'
  252.      displayed in the lower window bar just prior to the '<ESC>
  253.      to quit' message.  This has no affect on printing.  Despite
  254.      truncation, the ENTIRE file will be printed.  The file is printed
  255.      from the disc, not from memory.  Individual lines longer than 80
  256.      characters will be truncated to 80 characters on the display but
  257.      again, this does not affect the printed form.
  258.  
  259.           Because QuickPrint has to read the entire document one line at
  260.      a time, and formats each line for display, some longer files may
  261.      take quite a few seconds to be read, especially if on a floppy
  262.      disk.  After this is accomplished however, the file will be in
  263.      memory and no additional disk reads will be needed.
  264.  
  265.  
  266.           THE UPPER BAR WINDOW
  267.  
  268.           The left hand side of the bar displays the filename. To the
  269.      right of the filename it is indicated that F1 pulls up the
  270.      help screen. After viewing the help screen you may return to
  271.      viewing your document by pressing either the space bar, return
  272.      or escape keys.
  273.  
  274.           The keys operable while viewing a file are as follows:
  275.  
  276.                Alt-P - Pressing the Alt-P combination immediately
  277.                        starts printing.
  278.  
  279.                Alt-L - Will print with line numbers.
  280.  
  281.                Alt-M - Will set left hand margin. Valid margins
  282.                        are from 0 to 70 spaces.
  283.  
  284.                Alt-N - Sets number of lines printed per page.
  285.                        Valid numbers are 1 to 250.
  286.  
  287.                Alt-F - Send formfeed to printer
  288.  
  289.                Alt-R - Send linefeed to printer
  290.  
  291.                Alt-C - Version 2.60 does not automatically count
  292.                        the number of pages to print. This allows
  293.                        for much quicker loading of the file. You
  294.                        can get a count of the pages by pressing
  295.                        the Alt-C combination. The count will be
  296.                        displayed on the bottom line and will be
  297.                        provided in any case when you start printing
  298.                        since the program needs this information to
  299.                        track the progress of the print job.
  300.  
  301.                Alt-X - This will immediately exit the program without
  302.                        returning to the file directory.
  303.  
  304.                Alt-F5 - Toggles on and off the printing of the footer.
  305.                         ( filename, date, time and footer line )
  306.  
  307.                Alt-F6 - Toggles printing of page number.
  308.  
  309.      Block commands ( work only when viewing a file ):
  310.  
  311.                F7 - This marks the beginning of a block of text to print.
  312.  
  313.                F8 - Marks the end of the block.
  314.  
  315.                ALT-U - Unmarks the block of text.
  316.  
  317.      Navigational keys while viewing a file are:
  318.  
  319.                Home - This puts you at the very beginning of the file.
  320.                Twenty three lines are displayed at a time.
  321.  
  322.                End - This puts you at the very end of the file.  If the
  323.                file was truncated due to memory limitations, the last 23
  324.                lines of the shortened file will be displayed.
  325.  
  326.                Up and Down Arrows - Scrolls the cursor one line at a time
  327.                in their respective directions.
  328.  
  329.                Left and Right Arrows - puts the cursor at the top and
  330.                bottom of the screen respectively.
  331.  
  332.                PgUp and PgDn - Move through the file one screen at
  333.                a time, backward or forward respectively.
  334.  
  335.  
  336.           On the far right is the page number. This corresponds with
  337.      the printed page numbers.  NOTE: This is different than previous
  338.      versions where this was the display screen number which did not
  339.      correspond to printed page numbers.
  340.  
  341.           THE LOWER BAR WINDOW
  342.  
  343.           This is a rather dynamic window.  Most messages and
  344.      pertinent information will be displayed here.  When viewing
  345.      the file the line number will be displayed on the left hand
  346.      side. Then, either TOP or END will be displayed if you are
  347.      at the very top or bottom of the file. Then you will see the
  348.      word BLOCK if you have have turned on the block function (F7).
  349.      More information on the block function follows shortly.
  350.      Next, the number of print pages is given.  This number will
  351.      appear only if you first press Alt-C to get a count of the pages,
  352.      or if you print the file then return to viewing it. This is how
  353.      many pages the printed document will be.  If the document contains
  354.      formfeeds this number gives a count of them.  Otherwise, a printed
  355.      page contains 58 lines of print, not including the margins and footer.
  356.      This provides roughly a one-half inch margin both at the top and
  357.      below the footer.
  358.  
  359.      Fifty eight lines printed per page is the default number. This can
  360.      be changed by pressing the ALT-N key combination. The acceptable
  361.      range of lines per page is 1 to 250. Fifty five (or less) is
  362.      recommended for laser printers. A larger number can cause the footer
  363.      to be pushed onto the next page.
  364.  
  365.           To the right of the page count the amount of lines printed
  366.      per page will be diplayed as "Li=58" with the 58 being replaced
  367.      by the proper number should you decide to change the number. If
  368.      you change this number the amount of pages to be printed will be
  369.      adjusted accordingly.
  370.  
  371.           Just to the right of this number is the size of the margin.
  372.      The default is 0 ( "M=0" ). If the number is changed it will be
  373.      reflected in this display. For example, "M=5" for a margin of
  374.      5 spaces. The page count is not updated to reflect margin changes.
  375.  
  376.           If you select either Alt-M or Alt-N then decide to leave the
  377.      value as is, pressing enter without inputing any numbers will
  378.      abort the process and the values will remain unchanged.
  379.  
  380.           If the file was too big to fit in memory the letters "TR"
  381.      will appear after the margin number to indicate that the file
  382.      was (TR)uncated to fit in memory. Again, this has no effect on the
  383.      final print job.
  384.  
  385.           You will then see "FN". These two letters indicate that the
  386.      (F)ooter and page (N)umber will be printed.  You can toggle the
  387.      printing of these two components by pressing the Alt-F5 combination
  388.      for the footer and Alt-F6 for page number.  If you print with only
  389.      the page number it will be approximately centered on the bottom
  390.      of the page.  The footer (F) component contains the filename,
  391.      file date, file time and the line that runs across the page bottom.
  392.  
  393.           Finally, the last bit of information is self-explanatory.
  394.      <Esc> will always stop printing or terminate the viewing of a file.
  395.      If viewing a file it will put you back at the file directory. Pressing
  396.      the ALT-X combination will immediately exit the program and put
  397.      you back at the DOS prompt without displaying the filename list. If
  398.      you tagged files for a list <Esc> will put you back at the picklist.
  399.  
  400.  
  401.           BLOCK COMMANDS
  402.  
  403.           Pressing F7 turns on the block mode and highlights the line
  404.      the cursor is on.  You can either print this line alone or expand
  405.      the block by moving the cursor to the end of the desired block and
  406.      pressing F8. The entire block will now be highlighted. You can change
  407.      the size of the block by moving the cursor and pressing F8 again. All
  408.      the previously blocked text will remain highlighted and the additional
  409.      lines will now be included. If you move the cursor into the highlighted
  410.      area the new position will be the new block end and pressing F8 will
  411.      contract the highlighted text block accordingly. While the block mode
  412.      is on, the right hand side of the lower window will indicate how many
  413.      lines are blocked. This is helpful for printing purposes. Also, to
  414.      remind you that text is blocked the word block will be displayed
  415.      in the lower window with a blinking triangle. You may print a block
  416.      by pressing the Alt-P or Alt-L key combinations.  While printing, the
  417.      line number being printed is displayed on the left hand side.
  418.  
  419.           When you print a block the program will send footers and formfeeds
  420.      to the printer so if you blocked more than one page of text it will skip
  421.      over the perforation. However, it will not issue a formfeed at the
  422.      end of printing. This is to enable you to be able to print several
  423.      small blocks on one sheet of paper. Be careful though. If you print
  424.      several small blocks on one page the program does not know where the
  425.      perforation is so you should manually send a formfeed (ALT-F) when you
  426.      get near the bottom of the page.
  427.  
  428.           Once you have completed printing a block you can unmark it
  429.      by pressing ALT-U. Press F7 to start the block mode again.
  430.  
  431.      C.   PRINTING
  432.  
  433.           At any time you may start printing by pressing the ALT-P key
  434.      combination. Use the ALT - L combination if line numbers are
  435.      desired .   Make sure your printer is on and the paper is
  436.      properly lined up.  It's best to start printing at about one-half
  437.      inch from the top.  This gives the best appearance of vertically
  438.      centered text, including the footer.  Printing will always start
  439.      at the beginning of the file and will print the ENTIRE file, even
  440.      if it was truncated.
  441.  
  442.           While printing you will see several windows.  If you are
  443.      printing only one file ( no files were tagged ) the large central
  444.      window will display the text as it is sent to the printer (or buffer).
  445.      Below this will be displayed a horizontal progress bar that gives
  446.      you percentage of completion.  This is handy in that it allows you
  447.      to easily see the progress of the print job.
  448.  
  449.           If you tagged several files for printing, you will see the
  450.      list of files displayed in the main window rather than the text
  451.      that is printing.  You will however be advised of the status
  452.      of the print job by the progress bar.  The bar starts over for
  453.      each file.  The file that is printing is highlited in the window.
  454.      Files whose printing is complete are diplayed in reverse video.
  455.      The very bottom window will now show on the left, the number
  456.      of total print pages (in case you forgot).  In the central part,
  457.      the page being printed will be shown.  Between this and the progress
  458.      bar you'll have plenty of visual representation of the status of
  459.      your print job.
  460.           
  461. **        You can pause printing by pressing <ESC) or the spacebar.
  462.      At this point, any key except <ESC> will resume printing.
  463.      Pressing <ESC> again will terminate the print job and put you back
  464.      in the view mode ( or the file list if files were tagged and
  465.      you are printing from a list).  Therefore, the spacebar can act
  466.      as a toggle to alternately stop and start printing.
  467.  
  468.           If the printer is not on or not online, a message will appear
  469.      to alert you of this.
  470.  
  471.           If no formfeeds are detected, QuickPrint will add them, along
  472.      with a footer that provides the name of the file and it's date and
  473.      time on the left and the page number on the right if the the footer
  474.      toggles are on.
  475.  
  476.      D. FINAL COMMENTS
  477.  
  478.           Since reading the file is disk intensive, it would be faster
  479.      to use your hard disk if available.  This becomes especially
  480.      important for long files.
  481.  
  482.           QuickPrint stores the file in memory in slightly smaller than
  483.      65K chunks.  It would allow more of the file to fit in memory if
  484.      memory was contiguous and not "chopped up" by other programs.
  485.      Rebooting the computer will give you the largest possible
  486.      contiguous piece of memory.  Any TSR programs, RAM print buffers,
  487.      disk-caches, etc. will decrease available RAM for use by
  488.      QuickPrint.
  489.  
  490.           This program has been compressed with LZEXE91. This is an
  491.      excellent compression program that compresses executable files
  492.      and the program still remains executable - you don't have to wait
  493.      for it to decompress.  You will notice that it can be compressed
  494.      no further by using other compression utilities such as ARC or ZIP.
  495.  
  496.           In order to keep this a simple to use program it is minimally
  497.      configurable.  There are no command line "switches".  If you like
  498.      this program but would like some minor changes made, let me know.
  499.      I'll see what I can do to accommodate you. If you have a monochrome
  500.      VGA monitor I can provide you with a version that is configured with
  501.      colors that are more appropriate for the gray shading of these monitors.
  502.  
  503.           I am interested in your questions or comments.  Please feel
  504.      free to contact me at the following address or on CompuServe.  My
  505.      CompuServe ID number is 71541,743. I may also be contacted on GEnie,
  506.      where my address is J.DEROSE1.  If you like or even dislike this
  507.      program I encourage you to let me know.  Your responses are what
  508.      keeps me motivated to improve the program. All the changes in
  509.      previous versions  were the result of user's suggestions.
  510.  
  511.           Enjoy!
  512.  
  513.           Thank you.
  514.  
  515.  
  516.      Joseph L. DeRose
  517.      825 Dora Place
  518.      Bel Air, Maryland 21014
  519.  
  520.  
  521.  
  522.  
  523.      APPENDIX A
  524.      Summary of key combinations and examples of the status bars.
  525.  
  526.      F1    : Help screen.
  527.      ALT-P : PRINTS the document without line numbers.
  528.      ALT-L : PRINTS the document with line numbers.
  529.      ALT-M : Adds or changes the MARGIN on the left side.
  530.      ALT-N : Changes the number of LINES PRINTED per page.
  531.      ALT-C : COUNTS the number of pages that will be printed
  532.              taking into account the number of lines printed
  533.              per page.
  534.      ALT-F : Send FORMFEED to printer.
  535.      ALT-R : Send LINEFEED to printer.
  536.      ALT-D : UNTAG all filenames.
  537.      Space Bar : TAG/UNTAG a filename.
  538.      ALT-X : EXIT program without returning to directory.
  539.      ALT-F5: Toggles printing of (F)ooter.
  540.      ALT-F6: Toggles printing of page (N)umber.
  541.      F7    : Mark Beginning of BLOCK.
  542.      F8    : Mark End of BLOCK
  543.      ALT-U : UNMARK BLOCK
  544.  
  545.  
  546.      UPPER BAR
  547.  
  548.   File: <FILENAME.EXT>            < F1 for  HELP >            Page: ##
  549.                     ^                                         ^
  550.                     |                                         |
  551.                     |     Number of Print Page You Are Viewing
  552.                     Print Document
  553.  
  554.  
  555.  
  556.      LOWER BAR
  557.  
  558.  Line: ###     TOP  BLOCK   4 pages    Li= 58  M= 0  TR      <ESC> to Quit
  559.  ^             ^    ^       ^          ^        ^    ^                  ^
  560.  |             |    |       |          |        |    Truncation         |
  561.  |             |    |       |          |        Margin - Left Side      |
  562.  |             |    |       |          Lines Printed per Page           |
  563.  |             |    |       Num of Pages to Print                       |
  564.  Line Number   |    Displayed When in Block Mode                        |
  565.  of Text       "TOP" When at the Top of File                            |
  566.                "END" When at the End of File                            |
  567.                                                                         |
  568.                   This will be Replaced with the Number of Blocked Lines
  569.                   when the Block Function is on.
  570.  
  571.      
  572.      LOWER BAR WHEN PRINTING
  573.  
  574.  Pages: 4           Printing: 2        Li= 58  M= 0          <ESC> to Quit
  575.         ^                     ^
  576.         |                     |
  577.         |                     Page Being Printed
  578.         |
  579.         Number of Pages That Will be Printed
  580.